Step-by-Step Flutter SDK Installation
Flutter SDK installation is the first major step toward developing Flutter applications.
The Flutter SDK provides the Flutter framework, Dart SDK, command-line tools, debugging tools,
testing tools, and other components required to create and run Flutter applications.
According to the official Flutter documentation, the SDK includes the Dart SDK, Flutter CLI,
Flutter DevTools, rendering engine, widgets, testing APIs, and other development tools.
1. What is Flutter SDK?
Flutter SDK stands for Flutter Software Development Kit. It is a collection
of tools and libraries provided by Flutter for developing applications from a single codebase.
Flutter applications can target platforms such as Android, iOS, Web, Windows, macOS, and Linux.
Flutter SDK Includes
- Flutter Framework
- Dart SDK
- Flutter Command-Line Interface (CLI)
- Flutter Widgets
- Flutter DevTools
- Testing and debugging tools
- Build and compilation tools
- Platform integration APIs
The Flutter SDK also provides the flutter and dart command-line tools
used to create, run, test, and build applications.
2. Why Do We Need Flutter SDK?
Installing Flutter SDK gives developers access to the complete Flutter development environment.
Without the SDK, commands such as flutter create, flutter run,
and flutter doctor will not be available.
Important Reasons
- To create Flutter projects.
- To run Flutter applications.
- To compile Flutter applications.
- To use Dart programming language with Flutter.
- To debug applications.
- To run automated tests.
- To use Flutter DevTools.
- To manage Flutter packages and dependencies.
3. Supported Development Platforms
Flutter can be installed on multiple operating systems. The exact prerequisites depend on
the platform you want to develop on.
| Operating System |
Flutter Development |
| Windows |
Android, Web, Windows |
| macOS |
Android, iOS, Web, macOS |
| Linux |
Android, Web, Linux |
| ChromeOS |
Web and supported development environments |
For beginners, Flutter's documentation recommends trying Web development first because it
requires less additional platform-specific setup.
4. Prerequisites Before Installing Flutter
Before installing Flutter, make sure your computer has sufficient storage and that the required
development tools are available.
Basic Requirements
- A supported operating system.
- Internet connection for downloading Flutter and dependencies.
- Git, when required by the selected installation method.
- A code editor or IDE such as VS Code or Android Studio.
- Additional platform-specific tools if developing for Android, iOS, Windows, macOS, or Linux.
For Android development, Android Studio and the Android SDK are commonly used to provide the
Android development environment.
5. Download Flutter SDK
The first step is to download the Flutter SDK for your operating system.
Always prefer the official Flutter installation page or SDK archive when downloading Flutter.
Official Flutter Installation
Visit the official Flutter installation documentation to choose the appropriate installation
method and operating system.
Official Flutter Installation Documentation
Flutter SDK Archive
The Flutter SDK archive can be used when you need a particular Flutter release.
Flutter SDK Archive
6. Installing Flutter SDK on Windows
The following steps explain a traditional manual Flutter SDK installation on Windows.
Step 1: Download the Flutter SDK
Download the Windows Flutter SDK package from the official Flutter website.
The downloaded package is generally provided as a compressed archive.
Step 2: Create a Development Folder
Create a folder where the Flutter SDK will be stored. A simple location is:
C:\Users\YourName\develop
Flutter's documentation recommends using a location without unnecessary spaces or special
characters and avoiding locations that require elevated permissions.
Step 3: Extract Flutter SDK
Extract the downloaded Flutter archive into your development folder.
After extraction, you should have a folder similar to:
C:\Users\YourName\develop\flutter
Inside the Flutter folder, you will find directories and files required by the SDK.
One of the most important directories is the bin directory.
7. Understanding the Flutter SDK Folder
A simplified Flutter SDK structure looks similar to this:
flutter/
├── bin/
├── packages/
├── dev/
├── examples/
├── engine/
├── README.md
└── LICENSE
Important Directory: bin
The bin directory contains the command-line tools used to interact with Flutter.
flutter/
└── bin/
├── flutter
└── dart
The flutter/bin directory needs to be added to the system PATH so that
Flutter commands can be executed from a terminal.
8. Add Flutter to Windows PATH
Adding Flutter to the PATH allows you to execute Flutter commands from Command Prompt,
PowerShell, Windows Terminal, and compatible IDE terminals.
Step 1: Find Flutter bin Path
For example:
C:\Users\YourName\develop\flutter\bin
Step 2: Open Environment Variables
- Open Windows Search.
- Search for Environment Variables.
- Select Edit the system environment variables.
- Click Environment Variables.
Step 3: Edit PATH
- Under User variables, find Path.
- Select Path.
- Click Edit.
- Click New.
- Add the Flutter
bin directory.
- Click OK to save the changes.
Example:
C:\Users\YourName\develop\flutter\bin
Step 4: Restart Terminal
Close and reopen Command Prompt, PowerShell, Windows Terminal, and IDE terminals so that the
new PATH configuration is loaded.
9. Verify Flutter Installation
Open Command Prompt or PowerShell and run:
flutter --version
If Flutter is installed correctly, the terminal should display information about the installed
Flutter SDK.
Check Dart
dart --version
Dart is included with the Flutter SDK, so a working Flutter installation should also provide
the Dart command-line tool.
10. Run Flutter Doctor
One of the most important commands after Flutter installation is:
flutter doctor
For more detailed information, use:
flutter doctor -v
Flutter Doctor checks your development environment and reports missing dependencies or
configuration issues.
Example
Doctor summary:
[✓] Flutter
[✓] Android toolchain
[✓] Chrome
[✓] Visual Studio
[✓] Connected device
[✓] Network resources
The exact output depends on your operating system and the development platforms you have
configured.
11. Install VS Code
Visual Studio Code is a lightweight editor that can be used for Flutter development.
Flutter provides an official extension for VS Code.
Install Flutter Extension
- Open VS Code.
- Open the Extensions panel.
- Search for Flutter.
- Install the Flutter extension.
- The Dart extension is also installed or enabled as required.
Flutter's current documentation also provides a VS Code-based installation flow that can
download the SDK and add it to PATH.
12. Install Android Studio
If you want to develop Flutter applications for Android, you generally need the Android
development environment.
Android Studio Provides
- Android SDK
- Android SDK Platform Tools
- Android Emulator
- Android SDK Build Tools
- Android Virtual Device management
After installing Android Studio, open the SDK Manager and make sure the required Android SDK
components are installed.
13. Configure Android SDK
After installing Android Studio, Flutter may detect the Android development environment
automatically.
Run:
flutter doctor
If Flutter reports missing Android components, follow the instructions displayed by
flutter doctor.
14. Accept Android Licenses
For Android development, Flutter may ask you to accept Android SDK licenses.
Run:
flutter doctor --android-licenses
Read the license information and accept the required licenses when appropriate.
After completing the process, run:
flutter doctor
15. Configure an Android Emulator
An Android Emulator allows you to run a Flutter application without connecting a physical
Android phone.
Basic Process
- Open Android Studio.
- Open Device Manager.
- Create a new Virtual Device.
- Select an Android device model.
- Select a suitable Android system image.
- Complete the configuration.
- Start the emulator.
Then verify the connected device:
flutter devices
16. Use a Physical Android Device
Instead of an emulator, you can test Flutter applications on a physical Android device.
Basic Steps
- Enable Developer Options on the Android device.
- Enable USB Debugging.
- Connect the phone to the computer using USB.
- Allow the computer when the authorization prompt appears.
- Run
flutter devices.
flutter devices
If the device is detected correctly, it can be selected as the Flutter application's target
device.
17. Create Your First Flutter Project
Once Flutter is installed successfully, you can create a new Flutter project from the terminal.
Command
flutter create my_first_app
This command creates a new Flutter project named my_first_app.
Move Into the Project
cd my_first_app
Run the Application
flutter run
Flutter will build and launch the application on an available target device.
18. Flutter Project Structure
A newly created Flutter application contains several important files and directories.
my_first_app/
├── android/
├── ios/
├── lib/
│ └── main.dart
├── test/
├── web/
├── windows/
├── macos/
├── linux/
├── pubspec.yaml
└── README.md
Important Files
| File/Folder |
Purpose |
| lib/ |
Main Dart application source code. |
| lib/main.dart |
Common entry point of a Flutter application. |
| pubspec.yaml |
Project metadata, dependencies, assets, and configuration. |
| android/ |
Android-specific project files. |
| ios/ |
iOS-specific project files. |
| web/ |
Web-specific project files. |
| test/ |
Test files. |
19. Write a Simple Flutter Application
Open lib/main.dart and you can create a simple Flutter application.
import 'package:flutter/material.dart';
void main() {
runApp(const MyApp());
}
class MyApp extends StatelessWidget {
const MyApp({super.key});
@override
Widget build(BuildContext context) {
return MaterialApp(
debugShowCheckedModeBanner: false,
home: Scaffold(
appBar: AppBar(
title: const Text('My First Flutter App'),
),
body: const Center(
child: Text(
'Hello Flutter!',
style: TextStyle(fontSize: 24),
),
),
),
);
}
}
Run the application using:
flutter run
20. Understanding flutter pub get
Flutter projects use the pubspec.yaml file to define dependencies and project
configuration.
When dependencies are added or modified, run:
flutter pub get
This command downloads and resolves the packages specified in the project.
21. Important Flutter Commands
| Command |
Purpose |
flutter --version |
Displays Flutter version. |
dart --version |
Displays Dart version. |
flutter doctor |
Checks the development environment. |
flutter doctor -v |
Displays detailed diagnostic information. |
flutter devices |
Lists available devices. |
flutter create project_name |
Creates a new Flutter project. |
flutter run |
Runs a Flutter application. |
flutter pub get |
Gets project dependencies. |
flutter clean |
Removes generated build files. |
flutter upgrade |
Updates the Flutter SDK. |
22. Flutter Installation Using VS Code
Flutter also provides a streamlined installation method through VS Code and other
Code OSS-based editors.
Basic Process
- Install VS Code.
- Install the Flutter extension.
- Open the Command Palette.
- Select Flutter: New Project.
- When prompted for the Flutter SDK, select Download SDK.
- Select an installation location.
- Allow VS Code to download Flutter.
- Select Add SDK to PATH.
- Restart VS Code and terminal windows.
- Run
flutter doctor.
This method is useful for beginners because VS Code can guide the user through the SDK
installation and PATH configuration.
23. Flutter Installation on macOS
On macOS, Flutter can be installed manually or through a supported editor-based installation
workflow.
Example SDK Location
~/develop/flutter
Add Flutter to PATH
For the default Zsh shell, the Flutter SDK's bin directory can be added to
the PATH in the appropriate shell configuration file.
export PATH="$HOME/develop/flutter/bin:$PATH"
After updating the configuration, restart the terminal and verify:
flutter --version
dart --version
flutter doctor
For iOS development, additional Apple development tools such as Xcode are required.
24. Flutter Installation on Linux
On Linux, Flutter can be manually installed by downloading the appropriate SDK archive and
extracting it into a suitable directory.
Common Prerequisite Packages
sudo apt-get update
sudo apt-get install -y curl git unzip xz-utils zip libglu1-mesa
Example SDK Location
~/develop/flutter
Add Flutter to PATH
export PATH="$HOME/develop/flutter/bin:$PATH"
Then verify:
flutter --version
dart --version
flutter doctor
25. Common Flutter Installation Problems
Problem 1: flutter is not recognized
If you see an error similar to:
'flutter' is not recognized as an internal or external command
The Flutter SDK's bin directory may not be correctly added to PATH.
Solution
- Find the Flutter SDK location.
- Locate the
bin folder.
- Add the folder to PATH.
- Close the terminal.
- Open a new terminal.
- Run
flutter --version.
Problem 2: flutter doctor shows warnings
A warning from flutter doctor does not always mean Flutter itself is incorrectly
installed. It may indicate that a particular target platform has not been configured.
For example, if you only want to develop for Web, Android-specific warnings may not prevent
Web development.
Problem 3: Android licenses are missing
Run:
flutter doctor --android-licenses
Accept the required licenses and then run:
flutter doctor
Problem 4: Android device is not detected
Try the following:
- Check USB connection.
- Enable USB Debugging.
- Accept the authorization prompt on the phone.
- Check Android SDK installation.
- Restart ADB if necessary.
- Run
flutter devices.
Problem 5: Terminal does not recognize updated PATH
After changing PATH, existing terminals may continue using the old environment.
Close and reopen the terminal and restart the IDE.
26. Check Flutter Installation Completely
After completing the installation, run the following commands:
flutter --version
dart --version
flutter doctor
flutter devices
Then create a test project:
flutter create test_app
cd test_app
flutter run
If the application launches successfully, your basic Flutter development environment is ready.
27. Flutter PATH Explained
PATH is an environment variable that tells the operating system where executable programs can
be found.
When Flutter's bin directory is added to PATH, you can run:
flutter
dart
from different terminal locations without entering the complete SDK path every time.
Without PATH
C:\Users\YourName\develop\flutter\bin\flutter --version
With PATH
flutter --version
Therefore, adding Flutter to PATH makes command-line development much easier.
28. Updating Flutter SDK
Flutter releases updates that may include new features, bug fixes, performance improvements,
and compatibility changes.
To update an existing Flutter installation, use:
flutter upgrade
After upgrading, verify the environment:
flutter doctor
When upgrading a project, always review relevant migration information if your application
depends on older Flutter APIs or packages.
29. Check Flutter Version
To check the installed Flutter version:
flutter --version
For more detailed information:
flutter doctor -v
30. Flutter Channels
Flutter provides release channels for different development purposes. The exact availability
and recommendations can change over time, so developers should consult the official Flutter
documentation before switching channels.
For normal application development, the stable channel is generally the appropriate choice.
To check your current channel:
flutter channel
31. Recommended Installation Workflow
- Check your operating system.
- Install the required prerequisites.
- Download the Flutter SDK.
- Extract Flutter to a suitable development directory.
- Add
flutter/bin to PATH.
- Restart the terminal.
- Run
flutter --version.
- Run
dart --version.
- Run
flutter doctor.
- Install and configure an IDE.
- Configure the target platform.
- Create a test Flutter project.
- Run the project.
- Fix any issues reported by
flutter doctor.
32. Practical Example: Fresh Flutter Installation
Suppose a developer wants to install Flutter on Windows.
Step 1: Create Development Folder
C:\Users\Student\develop
Step 2: Extract Flutter
C:\Users\Student\develop\flutter
Step 3: Add PATH
C:\Users\Student\develop\flutter\bin
Step 4: Verify
flutter --version
dart --version
Step 5: Diagnose
flutter doctor
Step 6: Create Application
flutter create student_app
Step 7: Open Project
cd student_app
Step 8: Run Application
flutter run
This completes the basic Flutter installation and verification workflow.
33. Installation Checklist
| Task |
Status |
| Flutter SDK downloaded |
☐ |
| Flutter SDK extracted |
☐ |
| Flutter bin added to PATH |
☐ |
| Flutter version checked |
☐ |
| Dart version checked |
☐ |
| flutter doctor executed |
☐ |
| VS Code installed |
☐ |
| Flutter extension installed |
☐ |
| Android Studio installed if required |
☐ |
| Android SDK configured if required |
☐ |
| Android licenses accepted if required |
☐ |
| Emulator/device configured |
☐ |
| Test Flutter application created |
☐ |
| Flutter application successfully executed |
☐ |
34. Important Interview Questions
Q1. What is Flutter SDK?
Flutter SDK is a collection of Flutter libraries, Dart SDK, command-line tools, development
utilities, testing tools, and other components required to build Flutter applications.
Q2. What is the purpose of the Flutter bin directory?
The bin directory contains Flutter and Dart command-line tools. Its location is
added to PATH so that Flutter commands can be executed from the terminal.
Q3. Why do we add Flutter to PATH?
Adding Flutter to PATH allows the operating system to locate the Flutter command from the
terminal without requiring the complete path to the Flutter SDK.
Q4. What does flutter doctor do?
flutter doctor checks the Flutter development environment and reports configuration
issues, missing dependencies, and available development tools.
Q5. How can you check the Flutter version?
flutter --version
Q6. How can you create a new Flutter project?
flutter create my_app
Q7. How can you run a Flutter application?
flutter run
Q8. Is Dart installed separately with Flutter?
The Flutter SDK includes the Dart SDK, so installing Flutter provides the Dart command-line
tool as part of the Flutter development environment.
35. Key Points to Remember
- Flutter SDK is required for Flutter application development.
- The Flutter SDK includes Dart.
- The
flutter/bin directory should be available through PATH for command-line use.
flutter --version checks the installed Flutter version.
dart --version checks the Dart version.
flutter doctor diagnoses the development environment.
- Android development requires an appropriate Android development environment.
- iOS development requires macOS and Apple's development tools.
- VS Code can provide a streamlined Flutter installation workflow.
- Always restart terminals after modifying PATH.
- Use
flutter devices to check available devices.
- Use
flutter create to create a new project.
- Use
flutter run to run a Flutter application.
36. Flutter Training Resource
For structured Flutter learning, practical development, and guided training, you can explore
the Flutter training resource below:
JustAcademy Flutter Training
You can also register for a course demo using the following link:
Register for Flutter Course Demo
37. Conclusion
Installing the Flutter SDK is the foundation of Flutter application development. The complete
process involves downloading the SDK, extracting it to a suitable location, configuring PATH,
verifying Flutter and Dart, running flutter doctor, setting up an IDE, configuring
the desired target platform, and finally creating and running a test application.
Once the installation is successfully verified, you can start learning Dart, Flutter widgets,
layouts, navigation, state management, APIs, databases, animations, and complete Flutter
application development.
Basic installation workflow:
Download Flutter
↓
Extract Flutter SDK
↓
Add flutter/bin to PATH
↓
flutter --version
↓
dart --version
↓
flutter doctor
↓
Configure IDE
↓
Configure Target Platform
↓
flutter create my_app
↓
flutter run